Night Owl 6

home *** CD-ROM | disk | FTP | other *** search

/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 007a / jcal753.zip / JCAL.TXT < prev next >

Wrap

Text File | 1991-09-14 | 40KB | 821 lines

JCAL - THE JEWISH CALENDAR PROGRAM ================================== ABOUT THIS PROGRAM JCAL75.EXE is a program that calculates dates of the Jewish calendar. It was compiled with Turbo Pascal 5.5 and is based on three descriptions of the Jewish calendar which I recommend as additional reading on the subject: 1. The Jewish Calendar Mystery Dispelled by George Zinberg, Vantage Press, 1963 2. The Encyclopedia Judaica, "Calendar" 3. The Comprehensive Hebrew Calendar by Arthur Spier, Behrman House, Inc. THE JEWISH CALENDAR =================== HISTORY In biblical days, time was measured by observation of both the sun's pattern of motion and the lunar phases. The solar motion served to establish the duration of the year while the waxing and waning of the moon was a practical way to subdivide the year into months. But, unfortunately, the solar year and the lunar cycles are not synchronized. While the present calendar (Gregorian) had its roots in the lunar cycle as evidenced by the length of the months and even the word "month" itself, it was adjusted to the solar year in order to maintain the seasonal references - its relation to the lunar phases was eventually abandoned. The Jewish calendar, on the other hand, maintains both the lunar and solar relationship and also adjusts for certain religious requirements. The establishment of such a calendar was a remarkable accomplishment for a people living more than 2,000 years ago. Today it is known that one solar year is approximately 365 days, 5 hours, 48 minutes and 46 seconds. The lunar cycle is approximately 29 days, 12 hours, 44 minutes and 3 1/3 seconds (actually 2.841 seconds by current measurement). Therefore, twelve lunar months are 354 days, 8 hours, 48 minutes and 40 seconds, which falls short of a solar year by almost eleven days (10 days, 21 hours and 6 seconds). This difference will play an important role in the calendar calculations. Of course, a practical calendar must have a whole number of days in each month. Since the lunar month is very nearly 29 1/2 days, a calendar that has twelve months alternating between 29 and 30 days (averaging 29 1/2) would essentially follow the lunar cycle. In fact, this sequence forms the basis for the Jewish calendar. Such a year would have a length of 354 days, short by about eleven days from the solar year. If this were left uncorrected the seasons would quickly drift from their relationship to the months. However, many Jewish festivals are related to agricultural events and must occur during specific seasons. During the period of the Second Temple (built between 519 and 516 B.C.) and for three centuries after its destruction, a council of the Sanhedrin (the governing body of the time) decreed when the new months would begin and when adjustment was needed to compensate for the seasonal shifts. The start of each month was established by observing the arrival of the new moon. The council would meet on the thirtieth day of the month to hear the testimony of "two trustworthy witnesses" as to whether they observed the new crescent moon on that day. If they had, that day was declared the first of the new month. If they did not, then the next day was declared the first of the new month. Once the council had made their declaration the new month was announced by means of fire signals to inform the communities outside of Jerusalem. Distant villages which could not always receive prompt notice would celebrate the new moon for two days to be sure they had included the right day. The council was empowered to compensate for the solar and lunar differences by mandating that a "leap month" be inserted in the calendar every second or third year as the eleven day difference accumulated. They allowed for some flexibility, considering astronomical facts as well as religious and agricultural requirements. They observed the state of the crops, considered the need to make the Passover journey by way of muddy roads and tried to insert the leap month in an advantageous way. PRESENT JEWISH CALENDAR In 432 B.C. the Athenian astronomer Meton reformed the Athenian calendar based on an approximate relationship between the solar and lunar cycles. He had observed that every nineteen years the occurrences of the new and full moons returned to the same time with respect to the solar cycle. This pattern is known as the Metonic cycle. Actually, in nineteen years the annual difference (10 days, 21 hours and 6 seconds) accumulates to 206 days, 15 hours, 1 minute and 54 seconds. This accumulation is equal (within two hours) to seven lunar months (which come to 206 days, 17 hours, 8 minutes and 23 1/3 seconds). So if seven lunar months were added over a nineteen year period the lunar and solar cycles could be more or less maintained in synchronization. For the early Jews the day began and ended at sundown rather than at midnight. (Genesis says, "... and there was evening, and there was morning, one day"). For purposes of the Jewish calendar it still does. The new day (and hence the start of the Sabbath or a holiday) begins at sundown. However, for calendar calculations the day is considered to begin and end at 6 o'clock in the evening, Jerusalem time. The hour of 6 pm is therefore considered hour "zero". The hour was subdivided into 1080 "parts". So a part was 3 1/3 seconds and there were 18 parts in a minute. Each part was divided into 76 "moments". So there were 22.8 moments in a second. Many texts still refer to the use of "parts" but "seconds" will be used for the calculations described below. The chronology of the bible was calculated directly from the bible text and is given in the Talmud (a collection of Rabbinic writing created during the Hellenistic Age). The rabbis derived the following chronology: Year Event Comment ====== ======== ================ 1 Adam The Creation 1057 Noah 1056 years from Adam to Noah 1949 Abraham 892 years from Noah to Abraham 2049 Isaac 100 years from Abraham to Isaac 2239 Entrance into Egypt 190 years from Isaac to Egypt 2449 The Exodus 210 years from Egypt to Exodus 2929 Dedication of First Temple 480 years from Exodus to 1st Temple 3339 Destruction of First Temple 410 years duration of 1st Temple 3409 Return to Israel 70 years of Babylonian Exile 3829 Destruction of Second Temple 420 years duration of 2nd Temple Ancient names for the months are mentioned in Deuteronomy and Kings I but little else is known about the names of the months until the period of the Kings. At that time there was a reformation of the calendar and the months were referred to by their ordinal numbers (first, second, third month, etc.) and the start of the year was changed to the spring. By the end of the period of the Second Temple the months had again received names which are used today. The names are Babylonian and were probably adopted shortly after the Babylonian Exile. The Bible refers to Nisan, the month of spring and Passover, as the first month. Ancient writings actually refer to four different new years: Nisan 1 for Kings and festivals, Elul 1 for tithing of animals, Tishri 1 for the calendar and Shevat 1 or 15 for trees. Tishri 1 is now observed as the beginning of the year. There are numerous transliterations for Hebrew words. The spellings used here are those used in The Encyclopaedia Judaica. THE CALENDAR CALCULATIONS The rules for the present Jewish calendar system are believed to have been published by the patriarch Hillel II in the year 358, the Jewish year 4119. Rather than having the Sanhedrin determine when to add the leap month (Adar II), it was decided to introduce it exactly seven times every nineteen years. Furthermore, it was established that leap years would be the 3rd, 6th, 8th, 11th, 14th, 17th and 19th years of the cycle. Adar II, a 29-day month, would be added after Adar. Adar would be increased by one day to 30 days in a leap year giving it 30 days more than the ordinary year. Thus the Calendar would appear as shown in Table 1. Table 1 - Basis of Jewish Calendar Tishri 30 days Heshvan 29 days Kislev 30 days Tevet 29 days Shevat 30 days Adar 29 days (30 on a leap year) Adar II 29 days (inserted 7 times every 19 years) Nisan 30 days Iyyar 29 days Sivan 30 days Tammuz 29 days Av 30 days Elul 29 days Such a calendar would be reasonably accurate, with months based on the lunar cycle and with a correction for the solar year. To understand the other adjustments however, it is necessary to consider the Jewish holidays. The following table shows the traditional Jewish holidays. Table 2 - Jewish Holidays Hebrew Name Description Month Note ================================================================ Rosh Hashanah New Year Tishri 1 & 2 Tzom Gedaliah Fast of Gedaliah Tishri 3 1 Yom Kippur Day of Atonement Tishri 10 Succoth Tabernacles Tishri 15-21 Hoshanah Rabba Festival of Willows Tishri 21 Sh'mini Atzeret Closing Holiday Tishri 22 Simchat Torah Rejoicing of Torah Tishri 23 Hanukkah Festival of Lights Kislev 25 (8 days) Tzom Tevet Siege of Jerusalem Tevet 10 Tu B'Shevat New Year for Trees Shevat 15 Ta'anit Esther Fast of Esther Adar 13 2,3 Purim Feast of Lots Adar 14 3 Ta'anit Bechorim Fast of First Born Nisan 14 2 Pesach Passover Nisan 15-22 Yom Hashoah Holocaust Commem. Nisan 27 4 Yom Haatzmaut Israel Ind. Day Iyyar 5 2,5 Lag B'Omer 33rd Day of Omer Iyyar 18 Shavuot Festival of Weeks Sivan 6 & 7 Tzom Tammuz Fast of Tammuz Tammuz 17 1 Tisha B'Av Destr. of Temple Av 9 1 Notes 1. If date occurs on Sabbath, it takes place on following day, Sunday. 2. If date occurs on Sabbath, it takes place on preceding Thursday. 3. Adar II if leap year. 4. Established 1951. 5. Established 1949. Two problems exist with respect to these holidays. First, since Yom Kippur (Tishri 10) is a major fast day, it is undesirable for it to fall on a Friday or Sunday, adjacent to the Sabbath, because of limitations that would be imposed on the preparation for (or breaking of) the fast. Second, Hoshanah Rabba (Tishri 21) should not fall on a Saturday since the Sabbath laws would interfere with certain rituals. Both of these holidays occur in the first month, Tishri, so it can be said that Rosh Hashanah (Tishri 1, the New Year's Day) must not fall on a Wednesday, Friday, or Sunday. The Jewish calendar calculation is based on the following three steps. First, the new moon date and time (called the Molad) is calculated and the start of each month is first targeted for that date. Second, the day of Rosh Hashanah is adjusted according to rules discussed below. Third, a leap month is periodically introduced to maintain synchronization with the solar year. However, the processes of adjusting the occurrence of Rosh Hashanah is somewhat complex. It is accomplished by lengthening or shortening the prior year by one day. The month of Heshvan may be lengthened to 30 days and Kislev may be shortened to 29. When Heshvan is lengthened the year is called "full" and when Kislev is shortened the year is called "deficient". Otherwise it is called "normal". This means that three "types" of regular years can exist having totals of 353, 354 or 355 days. Furthermore, a leap year can also be deficient, normal or full and have lengths of 383, 384 or 385 days. Thus, the six possible types are: /-----REGULAR-----\ /-----LEAP YEAR-----\ Month DEF NORM FULL DEF NORM FULL ============================= ====================== Tishri 30 30 30 30 30 30 Heshvan 29 29 30 29 29 30 Kislev 29 30 30 29 30 30 Tevet 29 29 29 29 29 29 Shevat 30 30 30 30 30 30 Adar (I) 29 29 29 30 30 30 Adar II -- -- -- 29 29 29 Nisan 30 30 30 30 30 30 Iyyar 29 29 29 29 29 29 Sivan 30 30 30 30 30 30 Tammuz 29 29 29 29 29 29 Av 30 30 30 30 30 30 Elul 29 29 29 29 29 29 TOTALS 353 354 355 383 384 385 Notice that the period from Nisan 1 to Tishri 1 is always the same: 177 days, regardless of the type of year. By the application of certain rules discussed below it is possible to accommodate all the requirements of the Jewish calendar with a sequence of years having only these six lengths. Note that in a regular year Adar may be called "Adar I" or simply "Adar" whereas in a leap year the two Adars are called "Adar I" and "Adar II". The process of establishing the calendar for a particular year consists of the following steps: a) determine if the year is a leap year, b) find the day of the Molad (new moon) of Tishri for that year, c) adjust its Rosh Hashanah date according to the rules explained below, d) similarly, determine the Rosh Hashanah date of the next year, e) determine the length of the year (and hence its type) to fill the duration between the two Rosh Hashanah days. A set of rules has been established for determining how to position the day of Rosh Hashanah, given the day of the Molad. Determining if a year is a leap year is done by simply calculating its position in the 19-year cycle which began in the year 1. As was mentioned above, the duration between lunar cycles is 29 days, 12 hours, 44 minutes and 3 1/3 seconds. If the time of one Molad is known, the time of successive or previous ones can be determined by adding or subtracting multiples of this interval. From this process it is calculated that the first new moon of the year 1 took place on Sunday evening at 11 minutes, 20 seconds after 11 pm. The time of the Tishri Molad for any year can be determined by performing the previous calculation. But, since the lunar cycle repeats every 19 years, shortcuts can be taken. For example, it is only necessary to add 2 days, 16 hours, 33 minutes and 3 1/3 seconds to a particular new moon to find the day of the new moon exactly one 19-year-cycle later. Or 2 days, 23 hours, 5 minutes and 33 1/3 seconds have to be added to a particular new moon to find the new moon exactly 100 cycles (1900 years) later. Now the following rules are applied: Tishri 1 (Rosh Hashanah) will be on the day of the Molad except when falling into one of the four exceptions below (which is more often than not), in which case it is then delayed by one day. Rule 1: When the new moon occurs on Wednesday, Friday, or Sunday, or Rule 2: When the new moon occurs at noon (18 hours after the start of the day at sunset) or later, or Rule 3: When the new moon of an ordinary year occurs on Tuesday at 11 minutes and 20 seconds after 3 am or later, or Rule 4: When, at the termination of a leap year, the new moon occurs on Monday at 32 minutes and 43 1/3 seconds after 9 am or later. When Rules 2, 3, or 4 apply, if delaying Rosh Hashanah by one day causes it to fall within Rule 1, it is delayed a second day. EXPLANATION OF THE FOUR RULES The first rule causes the two holidays mentioned above to fall only on the permissible days. The second rule is an astronomical adjustment which considers the relationship between the observation of the new moon and the actual time of the lunar conjunction. Since the moon is in conjunction with the sun when it is "new", its first crescent is most readily observed just after sunset on the evening of the conjunction, but the actual conjunction may have occurred many hours before. The duration between the true conjunction and the observation of this first crescent is a complex calculation which takes into account the season, the lunar latitude and the geographical latitude and longitude of the place of observation. The second rule is an adjustment for the factors relating to the observation of the first crescent moon from the city of Jerusalem. The third rule accommodates the limitation imposed by having only the six possible year-lengths given above. If the new moon occurred on the stated time (or later) the Rosh Hashanah new moon of the following year would occur on Saturday at noon (or later). This can be seen by adding 4 days, 8 hours, 48 minutes and 40 seconds (the time that must be added to a new moon to find the new moon exactly 12 lunar months later) to 2 days, 3 hours, 11 minutes and 20 seconds. This would call for the application of the first two rules and the postponement of the Rosh Hashanah from Saturday to Monday. This, in turn, would require a year length of 356 days (50 weeks plus 6 days) which is not accommodated. So the Rosh Hashanah is postponed to Thursday (Rule 1 applies) and the year is 354 days long. The fourth rule is also necessary to accommodate the year length limitations but occurs very infrequently. If one subtracts the time necessary to calculate the new moon exactly 13 lunar months earlier (5 days, 21 hours, 32 minutes and 43 1/3 seconds) one finds that the new moon at the start of the year occurred at 12 noon on Tuesday. Under Rules 1 and 2 it would have been postponed until Thursday. This, in turn, would have required a 382-day leap year (54 weeks plus 4 days) which is not accommodated. So Rosh Hashanah is postponed to Tuesday and the year is 383 days long. SELECTING THE YEAR TYPE At this point, the Rosh Hashanah day calculation is made for the next year. The starting day and ending day of the year are then known as well as whether it must be a leap year. The year type is chosen from the six possibilities according to the length required. A simple way to chose the type is to use the table showing the number of days added from one New Year's Day to the next. Table 3 - Days Added to Year for Various Year Types Year Type Length Days Added ======================================== Deficient 353 3 days Normal 354 4 days Full 355 5 days Deficient-Leap 383 5 days Normal-Leap 384 6 days Full-Leap 385 0 days The type is now easily determined by examining the day of the week on which the year begins and ends. The application of Rules 3 and 4 above have assured us that these are the only types necessary to accommodate all situations. The year is now completely defined and the corresponding Gregorian dates must be found. CORRELATION TO THE GREGORIAN CALENDAR The correlation to the Gregorian calendar is very unsophisticated. Simply stated: there is no direct relationship between the Jewish and Gregorian calendars. They both are related to the solar cycle but according to totally different rules. Every date, in the course of the 19-year cycle can fall within a range of thirty days. The only way to determine corresponding Gregorian dates is to: 1) Have a known correspondence as a reference point. (Saturday, September 30, 1989, corresponds to Tishri 1, 5750.) 2) Count how many days in one calendar system exist between the reference date and the desired date. 3) Count the same number of days from the reference in the second calendar system. The calculations can take advantage of certain patterns to reduce their complexity. Charts and tables have been drawn up to help or a computer can be programmed to do the calculations. It is interesting to note that the Christian holiday of Easter and all the holidays tied to it also retain a relation to the lunar cycle. In the year 325, the date of Easter was set by the Council of Nicaea to be the first Sunday after the first full moon occurring on or after the vernal equinox. Because the calculations of the full moon and vernal equinox were too complex, the calculation was simplified to assume that the vernal equinox is always on March 21. Easter and Passover usually come within a week of each other, but in some Jewish leap years Passover occurs a whole month after Easter. ANNIVERSARIES Anniversaries can present a special problem for the Jewish calendar because there are often days that occur in one year which are absent in another. In the Gregorian calendar there is only one special case to con- sider, February 29th. People born or married on that date can simply decide to celebrate on February 28th or March 1st for years that are not leap years. But the Jewish calendar has an entire leap month as well as two months which can vary in length, so special rules have been establish- ed. The anniversary of the death of a close relative (called a Yahrzeit) is of particularly importance and has unique rules associated with it. 1) The anniversary of a date which was the 30th of Heshvan or Kislev in a year in which that month has 29 days is observed on the 1st of the next month. There is an exception for the observance of a Yahrzeit, namely: if, in the first year after the death, the anniversary month has 29 days then the Yahrzeit is observed on the 29th of that month and continues to be observed on the 29th for all years in which the anniversary month has only 29 days. 2) The anniversary of a date in Adar of an ordinary year is observed on the same date in Adar II of a leap year except for a Yahrzeit which is observed on the same date in Adar I of a leap year. 3) The anniversary of a date in Adar I of a leap year is observed on the same date in Adar of an ordinary year. If the original date was the 30th of Adar I of a leap year then, in an ordinary year, the anniversary is observed on the 1st of Nisan. There is an exception for the observance of a Yahrzeit. A Yahrzeit is observed on the 29th of Adar in an ordinary year. 4) The anniversary of a date in Adar II is observed on the same date of Adar of an ordinary year. THE GREGORIAN CALENDAR ====================== The calendar that we use today was first formulated in several inaccurate variations by the Romans. By the time of Julius Caesar January was falling in autumn so he ordered Sosigenes to make reforms to the calendar. He added 90 days to the year 46 B.C. to correct for the seasonal drift and adjusted the lengths of the months as we know them to be today. He introduced the leap year by adding one day to February every four years. The use of the leap year was an improvement but not entirely accurate. The true solar year is 365 days, 5 hours, 48 minutes, and 46 seconds. One 366-day year every four years equates to an average year of 365 days, 6 hours. Every four years an error of 44 minutes, 56 seconds was added. By the 16th century the accumulated error was ten days. Pope Gregory revised the calendar by suppressing the ten days between October 5th and October 15th of the year 1582 and ordained that years ending in hundreds should not be leap years unless they are divisible by 400. (1800 and 1900 were not leap years but 2000 is.) This Gregorian calendar is the one we use today. Incidentally, the Gregorian reform compensates by 72 hours (3 days) every 400 years. The actual excess accumulated is 74 hours, 53 minutes and 20 seconds. The error of 2 hours, 53 minutes and 20 seconds every 400 years accumulates to one day in 3323 years. Oh well, nobody's perfect. WEEKLY READINGS =============== The five books of the Old Testament (Torah) are divided into 54 weekly portions which are read, one each Sabbath, throughout the year. Only the last portion, Ve-Zot-ha-Berakhah, is not read on the Sabbath but on Simchat Torah. The new cycle begins on the Sabbath after Simchat Torah. Each weekly portion has an accompanying reading from one of the Prophets (Haftarah). These are all listed below. Torah Reading Prophets 1. Bereshit, Gen 1:1-6:8 Isa 42:5-43:11 2. No'ah, Gen 6:9-11:32 Isa 54:1-55:5 3. Lekh Lekha, Gen 12:1-17:27 Isa 40:27-41:16 4. Va-Yera, Gen 18:1-22:24 II Kings 4:1-37 5. Hayyei Sarah, Gen 23:1-25:18 I Kings 1:1-31 6. Toledot, Gen 25:19-28:0 Mal 1:1-2:7 7. Va-Yeze, Gen 28:10-32:3 Hos 12:13-14:10 8. Va-Yishlah, Gen 32:4-36:43 Hos 11:7-12:12 9. Va-Yeshev, Gen 37:1-40:23 Amos 2:6-3:8 10. Mi-Kez, Gen 41:1-44:17 I Kings 3:15-4:1 11. Va-Yiggash, Gen 44:18-47:27 Ezek 37:15-28 12. Va-Yehi, Gen 47:28-50:26 I Kings 2:1-12 13. Shemot, Ex 1:1-6:1 Isa 27:6-28:13, 29:22-23 14. Va-Era, Ex 6:2-9:35 Ezek 28:25-29:21 15. Bo, Ex 10:1-13:16 Jer 46:13-28 16. Be-Shallah, Ex 13:17-17:16 Judge 4:4-5:31 17. Yitro, Ex 18:1-20:23 Isa 6:1-7:6,9:5 18. Mishpatim, Ex 21:1-24:18 Jer 34:8-22, 33:25-26 19. Terumah, Ex 25:1-27:19 I Kings 5:26-6:13 20. Tezavveh, Ex 27:20-30:10 Ezek 43:10-27 21. Ki Tissa, Ex 30:11-34:35 I Kings 18:1-39 22. Va-Yakhel, Ex 35:1-38:20 I Kings 7:40-50 23. Pekudei, Ex 38:21-40:38 I Kings 7:51-8:21 24. Va-Yikra, Lev 1:1-5:26 Isa 43:21-44:23 25. Zav, Lev 6:1-8:36 Jer 7:21-8:3, 9:22-23 26. Shemini, Lev 9:1-11:47 II Sam 6:1-7:17 27. Tazri''a, Lev 12:1-13:59 II Kings 4:42-5:19 28. Mezora, Lev 14:1-15:23 II Kings 7:3-20 29. Aharei Mot, Lev 16:1-18:30 Ezek 22:1-19 30. Kedoshim, Lev 19:1-20:27 Amos 9:7-15 31. Emor, Lev 21:1-24:23 Ezek 44:15-31 32. Be-Har, Lev 25:1-26:2 Jer 32:6-27 33. Be-Hukkotai, Lev 26:3-27:34 Jer 16:19-17:14 34. Be-Midbar, Num 1:1-4:20 Hos 2:1-22 35. Naso, Num 4:21-7:89 Judge 13:2-25 36. Be-Ha''alotkha, Num 8:1-12:16 Zech 2:14-4:7 37. Shela Lekha, Num 13:1-15:41 Josh 2:1-24 38. Korah, Num 16:1-18:32 I Sam 11:14-12:22 39. Hukkat, Num 19:1-22:1 Judge 11:1-33 40. Balak, Num 22:2-25:9 Micah 5:6-6:8 41. Pinhas, Num 25:10-30:1 I Kings 18:46-19:21 42. Mattot, Num 30:2-32:42 Jer 1:1-2:3 43. Masei, Num 33:1-36:13 Jer 2:4-28, 3:4 44. Devarim, Deut 1:1-3:22 Isa 1:1-27 45. Va-Ethannan, Deut 3:23-7:11 Isa 40:1-26 46. Ekev, Deut 7:12-11:25 Isa 49:14-51:3 47. Re''eh, Deut 11:26-16:17 Isa 54:11-55:5 48. Shofetim, Deut 16:18-21:9 Isa 51:12-52:12 49. Ki Teze, Deut 21:10-25:19 Isa 54:1-10 50. Ki Tavo, Deut 26:1-29:8 Isa 60:1-22 51. Nizzavim, Deut 29:9-30:20 Isa 61:10-63:9 52. Va-Yelekh, Deut 31:1-30 Isa 55:6-56:8 53. Ha''azinu, Deut 32:1-52 II Sam 22:1-51 54. Ve-Zot ha-Berakhah, Deut 33:1-34:12 Josh 1:1-18 There are a sufficient number of portions to accommodate different readings on the longer years so it is necessary to double-up on some weeks in shorter years in order that all the portions be read. Also, there are special readings that are substituted on the holidays. These substitutions require a complex series of adjustments to be sure that all portions are read regardless of the year length. Special Haftarah readings are said when celebrating a new moon. To further complicate the matter, not all congregations observe the same rules. JCAL shows the Torah and Haftarah reading that normally would apply to that week as well as the substitutions that are often made. Note that for any particular date JCAL shows the reading for the subsequent sabbath not for the weekday or holiday reading that may occur on that date. The user is CAUTIONED to check these readings inasmuch as there will be variations from congregation to congregation. Note, also, that if Tisha B'Av falls on the Sabbath it is advanced by one day or if Yom Haatzmaut falls on a Friday or Saturday it is celebrated on the previous Thursday. SUNSET TIMES ============ When Item 4 is selected from the menu the time of sunset is shown for the Gregorian date selected. You can therefore calculate the time of sunset for any holiday as well as for the sabbath. The time of sunset is used to determine the time of candlelighting. It is customary to light candles on the Sabbath between 1 1/4 hours and 18 minutes before sunset. Since sunset varies according to one's location, it is necessary to tell the computer where you are. The calculation is controlled by parameters in a file called JCAL.SUN. It consists of five lines. They must contain the following: Line 1: City Name Line 2: Latitude (Latitudes south of the Equator are negative) Line 3: Longitude (East of Greenwich are negative) Line 4: Universal Time correction (zones east of Greenwich are negative) Line 5: Name of time zone All lines must be present. Latitude and longitude are in degrees and minutes with a decimal point between them. Thus 45 degrees, 37 minutes is written 45.37 Universal Time correction is according to the following table: Standard Daylight Eastern 5 4 Central 6 5 Mountain 7 6 Pacific 8 7 Latitude and Longitude of common cities are as shown: Latitude Longitude New York 40.45 73.59 Los Angeles 34.03 118.14 Chicago 41.52 87.38 Dallas 32.47 96.47 Miami 25.46 80.11 Montreal 45.30 73.33 San Francisco 37.46 122.24 Johannesburg -26.10 -28.02 (time correction = -1.5) Jerusalem 31.47 -35.13 (time correction = -3) Coordinates for other cities can be found in an Almanac. If the file is found to be missing a default file is automatically created which looks like this: New York 40.45 73.59 5 EST New files can be created with any text file editor or the default file can be edited. Its name must be JCAL.SUN. COMMAND LINE PARAMETERS ======================= There are two command line parameters that can be used when starting the program. The letter "n" will tell the program that there should be No opening screen and the letter "m" will start the program in a Monochrome mode. The latter uses two intensities of white characters on a black background and may give a better appearance on monochrome or composite monitors. Command line parameters can be entered in any order and can be upper or lower case. They are separated by a space. For example: to start JCAL (version 7.5) in monochrome and without the opening screen enter "JCAL75 m n". Note that you will need about 140k of available memory to run JCAL with the text file resident (selection 7) and about 80k without the text file resident You will be informed if the text file will not fit into memory. JCAL UTILITIES ============== JCAL is supplied with several utilities that can be used in conjunction with other software to convert between Gregorian and Jewish dates. J2G.EXE (Jewish-to-Gregorian) converts Jewish dates to Gregorian, G2J.EXE (Gregorian-to-Jewish) converts Gregorian dates to Jewish and READINGS.EXE supplies the Torah readings for the Sabbath following the Jewish date entered. They accept their inputs as command line parameters and send their outputs to the screen or to a file by redirection. Other application software such as dBASE III can execute them as a DOS program using the RUN command. Most programming languages have equivalent commands. BASIC uses the SHELL command and Turbo Pascal uses the EXEC command. dBase programmers, however, may want to use the binary files described later. G2J.EXE This program is executed by entering the following command: G2J MM/DD/YYYY MM/DD/YYYY is the Gregorian date to be converted such as 7/30/1936. Month and Date can be single digits but the year must be four digits. The delimiter can be "/", "-", or "," . Thus 1-1-1989 or 3,17,1918 are also acceptable inputs. The output is in the form MM/DD/YYYY. Month and date may be single digits but the year is always four digits. The months are given in numeric form as follows: Tishri 1 Heshvan 2 Kislev 3 Tevet 4 Shevat 5 Adar 6 Adar II 13 (when leap year); Nisan 7 Iyyar 8 Sivan 9 Tammuz 10 Av 11 Elul 12 Assigning the number 13 instead of 7 to Adar II allows the subsequent months to retain their same numbers whether leap year or not. Thus Nisan is always month 7 and Elul is always month 12 making application programming and data entry easier. Examples: G2J 7/28/1988 -- Sends 11/14/5748, the Jewish equivalent of July 28, 1988, to the screen. G2J 4,20,1970 > DFP.DAT -- Sends 7/14/5730, the Jewish equivalent of April 20, 1970, to a file called DFP.DAT. There is a special command line parameter, "T" or "t", for converting Today's date to the Jewish equivalent. Today's date is read from the computer's calendar and assumes it is correctly set. This output is formatted in a more readable form. Thus if today is July 30, 1988: G2J T - Sends "Sat, Av 16, 5748" to the screen. This command can be added to your AUTOEXEC.BAT file so the current Jewish date will be shown on the screen whenever you power up your computer. G2J must be accessible to the AUTOEXEC.BAT file. Using "TB" will give a "brief" output in the form of MM/DD/YYYY which is less readable but is convenient for piping into READINGS.EXE as described below. Example: G2J TB - Sends 11/16/5748 to the screen if today is July 30, 1988. J2G.EXE This program is executed by entering the following command: J2G MM/DD/YYYY S MM/DD/YYYY is the Jewish date to be converted such as 11/15/5748. Month and Date can be single digits but the year must be four digits. The date delimiter can be "/", "-", or "," . S is the number of successive years. It can be any size but the larger the number the longer the computation time. S is optional and defaults to 1 if not used. The outputting of successive years is particularly useful when calculating anniversaries and Yahrzeits for several years ahead. The output is in the form MM/DD/YYYY. Here, too, month and date may be single digits but the year is always four digits. The months are given in numeric form as described above. Remember that "13" is used to designate the leap year month of Adar II. Examples: J2G 11/16/5748 -- Sends 7/30/1988 to the screen. J2G 7/14/5730 20 > OUTFILE.DAT -- Sends 20 successive Gregorian dates starting with 4/20/1970 to a file named OUTFILE.DAT. READINGS This program takes the Jewish date entered at the command line and outputs the Torah reading for the Sabbath following that date. If no command line parameter is entered, the program waits for a date to be entered on the next line. NOTE THAT NO PROMPT IS SUPPLIED. This is done so that the output is only the Torah reading which can be redirected to another file without clutter. Examples: READINGS 11/11/5709 > BAR -- Sends "Va-Ethannan, Deut 3:23 -7:11" to a file called BAR. The ability of this program to accept input on a separate line without command line parameters makes it particularly easy to have its input supplied by piping it from G2J as illustrated below. G2J 8/6/1949 | READINGS will output the same "Va-Ethannan, Deut 3:23 - 7:11" to the screen. If you place the following lines in your AUTOEXEC.BAT file you will see the date and the Torah reading displayed each time you boot up your computer: G2J T G2J TB | READINGS dBASE Interface Two binary files J2GBIN.BIN and G2JBIN.BIN are also included. These can be LOADed and CALLed by a dBase program and are much faster than using the RUN command. They both require that a single date string be passed to it in the form MM/DD/YYYY. The converted date is returned in the same string variable. The variable MUST be padded to have a length of ten characters. A small demonstration is included to show the programmer how to use them. There are two additional files associated with the demo: JDB.PRG, JDB.DBF. Run JDB.PRG under dBASE III and study the code carefully to integrate the utilities into your application. SHAREWARE ========= Rather than marketing these programs I am distributing them as Shareware. Try the programs at no charge. They are not copy protected and you may distribute them freely to others. If you find them useful and continue to use them you must pay the $18 registration fee. Send the registration fee along with the program revision number (from the opening screen) to: Lester Penner 25 Shadow Lane Great Neck, NY 11021 (H) 516 466-5574 (W) 516 273-3100 Please send only US currency; no Canadian checks. You may send information about bugs to the same address or to Compuserve 75236,1572. Enjoy, Les